﻿//////////////////////////////////////////////////////////////////////////////
//
//  Copyright © 1998-2024 Glodon Company Limited.  All rights reserved.
//
//  Use of this software is subject to the terms of the Glodon license
//  agreement provided at the time of installation or download, or which
//  otherwise accompanies this software in either electronic or hard copy form.  
//
//////////////////////////////////////////////////////////////////////////////

#pragma once

#include "GbmpGuid.h"
#include "OwnerPtr.h"
#include <set>
#include "GcmpModelInterface.h"

namespace gcmp
{
    /// \brief 分类管理器
    ///
    /// 负责分类的集中管理，包括增加、查询、层次组织等等
    class GCMP_MODEL_INTERFACE_EXPORT IElementClassificationManager
    {
    public:
        static IElementClassificationManager* Get();

        /// \brief 增加分类
        ///
        /// 支持分类分层，叶子节点注册进来的时候挂接到其它非叶子分类中。
        ///
        /// \param currentClassificationGuid 当前分类的Guid
        /// \param description 当前分类描述信息
        /// \param parents 当前分类的父分类
        /// \return 添加成功返回true，否则返回false
        virtual bool AddClassification(
            Guid currentClassificationGuid,
            const std::wstring & description,
            const std::vector<Guid>& parents
        ) = 0;

        /// \brief 增加分类
        ///
        /// 支持分类分层，叶子节点注册进来的时候挂接到其它非叶子分类中。
        ///
        /// \param currentClassificationGuid 当前分类的Guid
        /// \param description 当前分类描述信息
        /// \param parent 当前分类的父分类
        /// \return 添加成功返回true，否则返回false
        virtual bool AddClassification(
            Guid currentClassificationGuid,
            const std::wstring & description,
            Guid parent
        ) = 0;

        /// \brief 根据Guid判断是否存在该分类
        /// \param classificationGuid 分类Guid
        /// \return 存在返回true,否则返回false
        virtual bool HasClassification(const Guid & classificationGuid) const = 0;

        /// \brief 根据分类的Guid获得其直接子分类
        /// \param classificationGuid 分类Guid
        /// \return 直接子分类Guid
        virtual std::vector<Guid> GetDirectChildClassifications(const Guid& classificationGuid) = 0;

        /// \brief 根据分类的Guid获得其所有子分类
        /// \param classificationGuid 分类Guid
        /// \return 所有子分类Guid
        virtual std::vector<Guid> GetAllChildClassifications(const Guid& classificationGuid) = 0;

        /// \brief 根据分类的Guid获得其所有叶子分类
        /// \param classificationGuid 分类Guid
        /// \return 所有叶子分类Guid
        virtual std::vector<Guid> GetAllLeafClassifications(const Guid& classificationGuid) = 0;

        /// \brief 内部调试用
        virtual void DumpLayerNodes() const = 0;
    protected:
        static IElementClassificationManager * s_pElementClassificationManager;
    };
}


